Kumo SSB Manager

Pepvoid can include Kumo, a graphical Site-Specific Browser manager for creating isolated desktop entries for web applications.

Enable it with:

sudo python3 cli.py x86_64 --desktop xfce --with-kumo --mode real

The kumo profile installs the system Python dependencies from XBPS and copies the bundled runtime into the image. It does not use pip, a developer virtual environment, or a source checkout at runtime. This keeps real builds reproducible and allows --with-custom-repo to reuse already indexed custom Python packages.

Installed files:

• /usr/share/kumo: application runtime, translations and image assets.

• /usr/bin/kumo: system launcher.

• /usr/share/applications/kumo.desktop: desktop menu entry.

• /usr/share/pixmaps/kumo.png: application icon.

Kumo detects installed browsers and uses xdg-open or the selected browser command to launch each SSB. Browser installation remains optional and is only requested when the user chooses it from the application.

Updating the bundled runtime

Refresh the runtime from a Kumo checkout with:

python3 tools/sync_kumo.py configs/custom_files/kumo/app

The synchronisation script excludes virtual environments, caches, generated documentation and bytecode.